home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.1 (Developer) [x86] / NeXT Step 3.1 Intel dev.cdr.dmg / usr / sybase / doc / dbiordesc.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  3.1 KB  |  89 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89 DBIORDESC    (UNIX only)
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  DBIORDESC    (UNIX only)
  6.  
  7.   FUNCTION:
  8.        Provide program access to the UNIX  file  descriptor  used  by  a
  9.        DBPROCESS to read data coming from SQL Server.
  10.  
  11.   SYNTAX:
  12.        int DBIORDESC(dbproc)
  13.  
  14.        DBPROCESS *dbproc;
  15.  
  16.   COMMENTS:
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   DBIORDESC    (UNIX only)Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.        o This routine provides a  way  for  an  application  to  respond
  28.          effectively to multiple input streams.  Depending on the nature
  29.          of your application, the time between a request for information
  30.          from  SQL Server  (usually  made via a call to dbsqlsend()) and
  31.          SQL Server's response (read by calling dbsqlok(),  dbresults(),
  32.          or  dbnextrow())  may  be significant. You may use this time to
  33.          service other parts of your application. The  DBIORDESC()  rou-
  34.          tine provides a way to obtain the I/O descriptor which a DBPRO-
  35.          CESS uses to read the data stream from SQL Server.  This infor-
  36.          mation  may  then be used with various operating system facili-
  37.          ties (such as the UNIX select() call) to allow the  application
  38.          to respond effectively to multiple input streams.
  39.        o The file descriptor returned by this routine may only  be  used
  40.          with operating system facilities that do not read data from the
  41.          incoming data stream. If data is read from this stream  by  any
  42.          means  other  than through a DB-Library routine, communications
  43.  
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89 DBIORDESC    (UNIX only)
  47.   ______________________________________________________________________
  48.          between the front-end and  SQL Server  will  become  hopelessly
  49.          scrambled.
  50.  
  51.        o An application can use  the  DB-Library  DBRBUF()  routine,  in
  52.          addition  to  the  UNIX  select()  function,  to help determine
  53.          whether any more data from SQL Server is available for reading.
  54.        o A companion routine, DBIOWDESC(), provides access to  the  file
  55.          descriptor used to write data to SQL Server.
  56.  
  57.        o For an example that illustrates the  use  of  DBIORDESC()  with
  58.          dbsqlsend() and dbsqlok(), see the DB-Library Reference Supple-
  59.          ment.
  60.  
  61.   PARAMETERS:
  62.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  63.            connection for a particular front-end/SQL Server process.  It
  64.            contains all the information that DB-Library uses  to  manage
  65.            communications and data between the front end and SQL Server.
  66.  
  67.  
  68.   DBIORDESC    (UNIX only)Version 4.0 -- 5/1/89                        4
  69.   ______________________________________________________________________
  70.  
  71.   RETURNS:
  72.        An integer file descriptor used by  the  specified  DBPROCESS  to
  73.        read data coming from SQL Server.
  74.  
  75.   SEE ALSO:
  76.        dbcmd,  DBIOWDESC,   dbnextrow,   DBRBUF,   dbresults,   dbsqlok,
  77.        dbsqlsend
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.